home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / tt_open.z / tt_open
Encoding:
Text File  |  2002-10-03  |  4.4 KB  |  66 lines
  1.  
  2.  
  3.  
  4. tttttttt____ooooppppeeeennnn((((3333))))                                                          tttttttt____ooooppppeeeennnn((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      tt_open - return the process identifier for the calling process
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<TTTTtttt////tttttttt____cccc....hhhh>>>>
  13.      cccchhhhaaaarrrr ****tttttttt____ooooppppeeeennnn((((vvvvooooiiiidddd))));;;;
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      The tttttttt____ooooppppeeeennnn() function returns the process identifier for the calling
  17.      process.
  18.  
  19. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  20.      The tttttttt____ooooppppeeeennnn() function also sets this identifier as the default procid
  21.      for the process.  The tttttttt____ooooppppeeeennnn(3) function is typically the first ToolTalk
  22.      function called by a process.
  23.  
  24.      The application must call tttttttt____ooooppppeeeennnn(3) before other _t_t_ calls are made.
  25.      However, there are two exceptions:  tttttttt____ddddeeeeffffaaaauuuulllltttt____sssseeeessssssssiiiioooonnnn____sssseeeetttt(3) and
  26.      tttttttt____XXXX____sssseeeessssssssiiiioooonnnn(3) can be called before tttttttt____ooooppppeeeennnn().
  27.  
  28.      A process can call tttttttt____ooooppppeeeennnn() more than once to obtain multiple procids.
  29.      To open another session, the process must make the following calls in the
  30.      order specified:
  31.  
  32.           tttttttt____ddddeeeeffffaaaauuuulllltttt____sssseeeessssssssiiiioooonnnn____sssseeeetttt(3)
  33.           tttttttt____ooooppppeeeennnn()
  34.  
  35. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  36.      Upon successful completion, the tttttttt____ooooppppeeeennnn() function returns the character
  37.      value that uniquely identifies the process.  The application can use
  38.      tttttttt____ppppttttrrrr____eeeerrrrrrrroooorrrr(3) to extract one of the following TTTTtttt____ssssttttaaaattttuuuussss values from the
  39.      returned pointer:
  40.  
  41.         TTTTTTTT____OOOOKKKK   The operation completed successfully.
  42.  
  43.         TTTTTTTT____EEEERRRRRRRR____NNNNOOOOMMMMPPPP
  44.                 The ttttttttsssseeeessssssssiiiioooonnnn(1) process is not running and the ToolTalk
  45.                 service cannot restart it.
  46.  
  47. AAAAPPPPPPPPLLLLIIIICCCCAAAATTTTIIIIOOOONNNN UUUUSSSSAAAAGGGGEEEE
  48.      The application should use tttttttt____ffffrrrreeeeeeee(3) to free any data stored in the
  49.      address returned by the ToolTalk API.
  50.  
  51.      Each procid has its own associated file descriptor, and can join another
  52.      session.  To switch to another procid, the application should call
  53.      tttttttt____ddddeeeeffffaaaauuuulllltttt____pppprrrroooocccciiiidddd____sssseeeetttt().
  54.  
  55. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  56.      TTTTtttttttttttt____cccc(5), tttttttt____ffffdddd(3), tttttttt____ddddeeeeffffaaaauuuulllltttt____pppprrrroooocccciiiidddd(3), tttttttt____ddddeeeeffffaaaauuuulllltttt____pppprrrroooocccciiiidddd____sssseeeetttt(3),
  57.      tttttttt____ddddeeeeffffaaaauuuulllltttt____sssseeeessssssssiiiioooonnnn(3), tttttttt____ddddeeeeffffaaaauuuulllltttt____sssseeeessssssssiiiioooonnnn____sssseeeetttt(3), tttttttt____ppppttttrrrr____eeeerrrrrrrroooorrrr(3),
  58.      tttttttt____ffffrrrreeeeeeee(3).
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.